<div id="content">
	<div class="help">
		<h1>Items&nbsp;&mdash;&nbsp;Help Documentation</h1>
		<h2>Overview</h2>
		<p>
			This website supports adding and tracking "items."  When logged in, The Items submenu lists all 
			possible tasks you can complete as a user.  This Documentation will outline what you can do in
			each task.
		</p>
		<p class="notice">
			Some tasks can only be performed by certain users.  If you do not have the correct permissions,
			you will not be able to perform a certain task.
		</p>
		<h2>Help Topics<h2>
		<ul class="links">
			<li><%= link_to "All Items", :anchor => "index" %></li>
			<li><%= link_to "Incoming Items", :anchor => "incoming" %></li>
			<li><%= link_to "Outgoing Items", :anchor => "outgoing" %></li>
			<li><%= link_to "Item Information", :anchor => "show" %></li>
			<li><%= link_to "Lookup Items", :anchor => "lookup" %></li>
			<li><%= link_to "Add New Items", :anchor => "new" %></li>
			<li><%= link_to "Checkin Items", :anchor => "checkin" %></li>
			<li><%= link_to "Lost Items", :anchor => "lost" %></li>
			<li><%= link_to "Add / Remove Items from a Container", :anchor => "add_remove_container" %></li>
		</ul>
		<p>&nbsp;</p>
		<div class="help-section">
			<a name="index"></a><h2>All Items</h2>
			<p class="notice">
				All users can use this functionality.
			</p>
			<p>
				If you click on <i>Items</i> from the left submenu, you will be able to view a list of all
				items in the system.  The list will show the Item Type (Specimen, Bag, etc), the Identifier
				of the Item (displayed on the barcode), where the Item is on its path to its destination, 
				where it was created, and its destination.  It will also show any attributes associated 
				with that item.
			</p>
			<p>
				If you click on a row in the list, you will be redirected to the 
				<%= link_to "Item Information", :anchor => "show" %> for that Item.
			</p>
			<p>
				There is also a tool for filtering the items in the list.  You can filter by Item Type, 
				Delivery Status, and Item Attribute.  When you select the filter you want to use, you can 
				click <i>Filter</i> to reload the page with the specified filters.  You can remove or 
				change filters by changing the combo box, selecting &quot;Type,&quot; &quot;Status,&quot;
				or &quot;Attribute&quot; to clear that filter and then clicking filter again.  To clear 
				the entire filter, you can click &quot;Clear.&quot;
			</p>
			<p>
				You can also flip through pages in the list by using the paging tool at the bottom of the 
				list.
			</p>
		</div>
		<div class="help-section">
			<a name="incoming"></a><h2>Incoming Items</h2>
			<p class="notice">
				All users except for Couriers can use this functionality.
			</p>
			<p>
				To view a list of Incoming Items, click on <i>Incoming</i> from the left submenu.
				This view will show all items going to the user's location.  For example, if you were 
				located at Harborview Medical Center, this would show all items going to Harborview and
				have not yet been delivered. Please see the <%= link_to "All Items", :anchor => "items" %> 
				section for details on what is in the list.
			</p>
		</div>
		<div class="help-section">
			<a name="outgoing"></a><h2>Outgoing Items</h2>
			<p class="notice">
				All users except for Couriers can use this functionality.
			</p>
			<p>
				To view a list of Outgoing Items, click on <i>Outgoing</i> from the left submenu.
				This view will show all items leaving the user's location.  For example, if you were 
				located at Harborview Medical Center, this would show all items that originated from 
				Harborview and have not yet been delivered. Please see the <%= link_to "All Items", :anchor => "items" %> 
				section for details on what is in the list.
			</p>
		</div>
		<div class="help-section">
			<a name="show"></a><h2>Item Information</h2>
			<p class="notice">
				All users can use this functionality.
			</p>
			<p>
				The item information page is viewable by clicking on an item in an item list or by looking
				up an item in <%= link_to "Lookup", :anchor => "lookup" %> or <%= link_to "Checkin", :anchor => "checkin" %>.
				This page includes a complete history of where the Item has been checked in, any comments 
				about that item, and, if the item is a container, a list of items within that container.  
				You can add your own comment to this item by entering text into the &quot;Comments&quot; 
				text box and then clicking <i>Comment</i>.
			</p>
		</div>
		<div class="help-section">
			<a name="lookup"></a><h2>Lookup Items</h2>
			<p class="notice">
				All users can use this functionality.
			</p>
			<p>
				You can Lookup an Item's information by clicking on <i>Lookup</i> from the left submenu.
				This will at first give you a blank page with a search bar.  Use a barcode scanner
				to scan the item you wish to lookup, or enter the identifier of that item by hand.  Then 
				click <i>Lookup</i> and you will be redirected to the <%= link_to "Item Information", :anchor => "show" %>
				of the item with that Identifier.
			</p>
		</div>
		<div class="help-section">
			<a name="new"></a><h2>Add New Items</h2>
			<p class="notice">
				All users except for Couriers can use this functionality.
			</p>
			<p>
				You can Add a New Item by clicking <i>Add New</i> from the left submenu. This will open a 
				form that you can fill out according to the item.  You can specify the following information:
			</p>
			<ul>
				<li>
					<b>Item Type:</b> The type of the item (Specimen, Bag, etc)
				</li>
				<li>
					<b>Identifier:</b> The ID used to identify the item by Couriers and other users.
					If you leave this field blank, an identifier will be automatically generated for 
					you.
				</li>
				<li>
					<b>Send To:</b> The destination of the item.  This will be displayed to the courier
					so they know where to transport your item to.
				</li>
				<li>
					<b>Attributes:</b> Traits specific to that item such as cap color, transport 
					conditions, etc.  Some attributes can have more than one value. For example, an item
					can be both "Fragile" and "Special." In these cases, the attributes will be displayed as
					checkboxes, allowing you to choose multiple attributes.  Otherwise, attributes such as 
					transport conditions can only have one value, in which case you'll see a combo box.
					Additionally, some attributes are required for items to have, while others are not.
				</li>
				<li>
					<b>Comments:</b> You can optionally provide a personal comment about the item,
					listing special care instructions or other details regarding the item.
				</li>
			</ul>
			<p>
				If you select a container as the item type, such as a bag, you can additionally add more 
				items to that bag.  When you select a container, another part of the page will become 
				visible at the bottom of the form.  You can choose to <i>Add new Item to Container</i>
				to add multiple items to be held in the container.  You will be able to 
				specify <b>Item Type</b>, <b>Identifier</b>, <b>Attributes</b>, and <b>Comments</b> for the
				contained item.
			</p>
			<p class="notice">
				Not all properties will be editable in contained items.  For example the destination and
				some attributes such as Transport Conditions must be the same as the container and will 
				therefore not be editable within the contained item.  However, these traits will be part of 
				the contained item when created.  You will also only be able to select non-containers to 
				store inside containers.
			</p>
		</div>
		<div class="help-section">
			<a name="checkin"></a><h2>Checkin Items</h2>
			<p class="notice">
				All users except for Couriers can use this functionality.
			</p>
			<p>
				When an item has reached its destination, it is the responsibility of the Lab Workers (or
				Clients) to confirm that the item has arrived.  They can do so by clicking <i>Checkin</i>
				in the left submenu.  This opens a page similar to the <%= link_to "Lookup", :anchor => "lookup" %>
				page.  However, the main difference is that when you search for the item, you can also 
				check that item in.  By entering the item identifier and clicking <i>Lookup</i>, you will 
				be led to the <%= link_to "Item Information", :anchor => "show" %> page.  By reviewing the 
				item information and scrolling to the bottom to click <i>Checkin</i>, a Lab Worker or 
				Client can check in that item (and all of its contained items). Now these items will 
				appear as delivered in the system.
			</p>
		</div>
		<div class="help-section">
			<a name="lost"></a><h2>Lost Items</h2>
			<p class="notice">
				All users except for Couriers can use this functionality on the website.
			</p>
			<p>
				When an item does not reach its destination, or when a courier misses it while in transit,
				that item can be marked as lost. A lab worker can mark an item as lost by clicking <i>Mark as Lost</i>
				in the Item Information page. Lost Items can be viewed by clicking <i>Lost</i> in the left submenu.
				This opens a page where you can view lost items that are either from or being 
				delivered to your location. Clicking <i>Add a Lost Item</i> allows you to enter in a barcode and
				an optional comment, and mark that item as lost. An item can also be marked as lost from its information page.
			</p>
			<p>
				After you have reported an Item is lost, the Item can be resolved.  Users resolve a lost item
				by clicking <i>Lost</i> in the left submenu, finding the item in the list, and clicking on the row of the item.
				This will lead them to a page to edit the lost item information.  Users can update the comment on the lost item
				and mark it as resolved if needed.  Resolved items that were lost will still show up as lost, but 
				when inspected, users can see that the issue has been resolved.  Resolved items can be hidden in the Lost Items List
				by toggling the <i>Show/Hide Resolved</i> link above the list.
			</p>
		</div>
		<div class="help-section">
			<a name="add_remove_container"></a><h2>Add / Remove Items from a Container</h2>
			<p class="notice">
				All users except for Couriers can use this functionality.
			</p>
			<p>
				If you wish to add an Item to a Container (such as adding a Specimen to a Bag) or remove an item
				from a bag, you can do so from the <%= link_to "Item Information", :anchor => 'show' %> page.
				This functionality is in place in case you forgot to add an item or added an item to the wrong bag 
				and want to go back to fix it.
			</p>
			<h3>Adding an Item to a Container</h3>
			<p>
				If you click <i>Add to Bag</i> (or whatever type of container you are adding to), you will be led to a page
				where you can add items to the container.  On the left, you can choose to add existing Items that have already
				been added to the system and are not already in a container (NOTE you can only choose from items in the system 
				that have the same source, destination, and inherited attributes such as Transport Conditions).  You can add 
				multiple existing items by clicking <i>Add Another</i> at the bottom of the Existing Items table.
			</p>
			<p>
				On the right, you will be able to add new items to the system that have the specified container as their container.
				See <%= link_to "Adding New Items", :anchor => 'new' %> to read about adding new items to a container.
			</p>
			<h3>Removing an Item from a Container</h3>
			<p>
				In the Items Information page at the bottom, you can Remove specific items from a container by clicking <i>Remove</i>
				next to the item you want to remove from the bag.
			</p>
			<p class="notice">
				This will not delete the item, just remove it from that container.
			</p>
		</div>
	</div>
</div>